home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 1997 August / Macworld (1997-08).dmg / Shareware World / Comms & Internet / SB112 / Plugin Docs / Plugin Language Changes < prev    next >
Encoding:
Text File  |  1997-06-17  |  1.3 KB  |  46 lines  |  [TEXT/ttxt]
  1. ShadowBotScripting Language, Version 1.1.2
  2. © John Bafford, 1997
  3.  
  4. This document describes the changes in the plugins language between ShadowBot 1.1.1 and 1.1.2.
  5.  
  6. Scripting Commands Changes
  7.  
  8. @GETARGS <numArgs>
  9. Causes ShadowBot to process the command's arguments. Returns the number of arguments found (equal to or less than numArgs) in the variable $NUMARGS.
  10.  
  11.     Example:
  12.     !command arg1 arg2 arg3 arg4
  13.  
  14.     @GETARGS 3
  15.         $ARG1 = 'arg1'
  16.         $ARG2 = 'arg2'
  17.         $ARG3 = 'arg3 arg4'
  18.         $NUMARGS = 3
  19.  
  20.     @GETARGS 5
  21.         $ARG1 = 'arg1'
  22.         $ARG2 = 'arg2'
  23.         $ARG3 = 'arg3'
  24.         $ARG4 = 'arg4'
  25.         $NUMARGS = 4
  26.  
  27. @IF command: when checking strings, you must put double quotes around both strings:
  28. Before: @IF "$ARG1" = blah goto else
  29. Now: @IF "$ARG1" = "blah" goto else
  30.  
  31. Script Configuration Changes
  32.  
  33. *COMMAND no longer takes a numArgs parameter.
  34.  
  35. *MAXRUNNING <number>
  36. If this configuration command is found, and number > 0, the last *COMMAND or *ONTEXT is limited to number simultaneous executions.
  37.  
  38. Script Variable Changes
  39.  
  40. $NUMARGS   - the number of arguments returned after a call to @GETARGS. $NUMARGS is -1
  41.              before this point.
  42. $ARGL      - returns the argument list.
  43. $ARGx      - $ARG0 returns the command name used. After processing with @GETARGS, 
  44.              $ARGx, 1 < x < 10 returns the xth argument. If there is no xth argument,
  45.              $ARGx returns an empty string.
  46.